home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d12 / pcmag.arc / MANUAL < prev    next >
Text File  |  1988-01-10  |  97KB  |  2,925 lines

  1.  
  2.         *==============================================================*
  3.         |                                                              | 
  4.         |                                                              |
  5.         |                                                              |
  6.         |                                                              |
  7.         |                                                              |
  8.         |                                                              |
  9.         |                   The PC Magazine Utilities                  |
  10.         |                                                              |
  11.         |                           Volume I                           |
  12.         |                                                              |
  13.         |         Copyright (C) 1986 Ziff-Davis Publishing Co.         |
  14.         |                                                              |
  15.         |        Manual assembled and edited by Craig L. Stark         |
  16.         |                                                              |
  17.         |                                                              |
  18.         |                                                              |
  19.         |                                                              |
  20.         |                                                              |
  21.         |                                                              |
  22.         |                                                              |
  23.         *==============================================================*
  24.  
  25.  
  26.  
  27.  
  28.           ATTR (Attribute)                       Charles Petzold
  29.           Command                                          No. 1
  30.  
  31.           ______________________________________________________
  32.  
  33.           Purpose:  ATTR.COM permits display and modification of
  34.                     the archive, system, hidden, and read-only
  35.                     file attributes.
  36.  
  37.           Format:   ATTR
  38.                       or
  39.                     ATTR *.*
  40.                       or
  41.                     ATTR [+A|-A] [+S|-S] [+H|-H] [+R|-R]
  42.                     [d:][path]filename[.ext]
  43.  
  44.           Remarks:  Entering ATTR without any parameters, as in
  45.                     the first format shown above, produces a help
  46.                     display (essentially identical to the third
  47.                     form above) that shows which file attributes
  48.                     can be changed.
  49.  
  50.                     ATTR.COM permits the use of the global ? and
  51.                     * characters (as in the second format above).
  52.                     Entering ATTR filename displays a specific
  53.                     file's attributes.  For example,
  54.  
  55.                          ATTR IBMBIO.COM
  56.  
  57.                     returns the display
  58.  
  59.                          IBMBIO.COM    Arc     Sys Hid R-O
  60.  
  61.                     showing that the Archive, System, Hidden, and
  62.                     Read-Only bits of the attribute byte are set
  63.                     for this file.
  64.  
  65.                     When wildcards are used to list the
  66.                     attributes of all the files in a directory,
  67.                     subdirectory names are shown as Dir (between
  68.                     the Arc and Sys in the example above).
  69.                     Unlike the DOS DIR command, ATTR lists hidden
  70.                     files, whether sought by specified filename
  71.                     or through a *.* listing.  However, ATTR does
  72.                     not show Volume names or the dot and double-
  73.                     dot entries in subdirectories.
  74.  
  75.                     The syntax for changing file attributes is
  76.                     indicated in the third format above.  After
  77.                     typing ATTR (and a space) you simply precede
  78.                     the file specification with a plus or minus
  79.                     sign, followed by the letter A (Archive), S
  80.                     (System), H (Hidden), or R (Read-Only).  A
  81.                     plus sign turns on the specified attribute; a
  82.                     minus sign turns it off.  More than one
  83.                     attribute can be changed at once, and the
  84.                     attribute-designating letters may be entered
  85.  
  86.  
  87.  
  88.  
  89.                                  Page -1-
  90.                     in any order and in upper- or lowercase.  No
  91.                     space may be used between the plus or minus
  92.                     and the letter that follows it, however.
  93.  
  94.           Example:  To convert the file 85TAX.WKS to hidden and
  95.                     read-only, you would enter
  96.  
  97.                     ATTR +H +R 85TAX.WKS
  98.  
  99.                     Since DOS itself normally sets the Archive
  100.                     bit, entering
  101.  
  102.                           ATTR 85TAX.WKS
  103.  
  104.                     would produce the display
  105.  
  106.                          85TAX.WKS     Arc         Hid R-O
  107.  
  108.                     Since the Hidden attribute has been set,
  109.                     however, the  DIR command will produce the
  110.                     message, "File not found."  And since the
  111.                     Read-Only flag has also been set, a DEL
  112.                     command will produce the message, "Access
  113.                     denied."
  114.  
  115.                     Notes:
  116.  
  117.                     1.   Requires DOS 2.0 or later.
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.                                  Page -2-
  152.  
  153.           BAC (Backup Directory)                  John Dickinson
  154.           Command                                          No. 2
  155.           _______________________________________________________
  156.  
  157.           Purpose:  Backs up all (or selected) files in a
  158.                     directory to hard or floppy disks, permitting
  159.                     disk changes when target disks become full.
  160.  
  161.           Format:   BAC [d:][path]filename[.ext] [d:][path]
  162.  
  163.           Remarks:  Unlike the DOS COPY command, BAC.COM permits
  164.                     you to change (formatted) target disks when
  165.                     backing up files to disk.  Furthermore, it
  166.                     only backs up files whose date stamp is later
  167.                     than those of identically named files on the
  168.                     target disk.  Unlike BACKUP, BAC does not
  169.                     change the setting of the archive bit.  Also,
  170.                     files copied with BAC.COM are fully usable at
  171.                     all times; they do not need first to go
  172.                     through a RESTORE process.
  173.  
  174.                     BAC.COM supports the use of global (* and ?)
  175.                     characters in filenames and extensions.  It
  176.                     does not, however, permit you to REName files
  177.                     during copying.
  178.  
  179.           Example:  You are working at a PC AT with a hard disk
  180.                     drive (C:) on which you keep your copy of
  181.                     BAC.COM, and you want to back up all the .DOC
  182.                     files stored on a 1.2-Mb floppy disk (drive
  183.                     A:) onto  regular 360K disks (drive B:).
  184.                     Since these .DOC files will require
  185.                     approximately 600K, you must have two
  186.                     formatted blank floppy disks ready to use in
  187.                     drive B:.  From the C> prompt you enter
  188.  
  189.                          BAC A: *.DOC B:
  190.  
  191.                     When the first target disk in drive B: is
  192.                     full, you will be prompted to change disks.
  193.  
  194.                     Notes:
  195.  
  196.                     1.   BAC.COM compares the date stamps of
  197.                          identically named files and will not
  198.                          overwrite a newer version with an older
  199.                          one.  This may cause files to be skipped
  200.                          if you omit to keep your date/time
  201.                          current.
  202.  
  203.                     2.   Requires DOS 2.0 or later.
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.                                  Page -3-
  215.  
  216.           Browse                                 Charles Petzold
  217.           Command                                          No. 3
  218.  
  219.           _______________________________________________________
  220.  
  221.           Purpose   Permits scrolling forward and backward
  222.                     throughout a file without use of a word
  223.                     processing program.
  224.  
  225.           Format:   BROWSE [d:][path]filename[.ext] [/W]
  226.  
  227.           Remarks:  The DOS TYPE command does not permit you to
  228.                     scroll ahead or go back to previously
  229.                     displayed material in a file.  It also exits
  230.                     at the first instance of Ctrl-Z (ASCII 26,
  231.                     conventionally used as an End-of-File
  232.                     marker), making it impossible to scan binary
  233.                     (e.g. .COM) files for error messages,
  234.                     copyright notices, and the like.
  235.  
  236.                     BROWSE.COM overcomes these shortcomings,
  237.                     giving you the chance to go immediately to
  238.                     the top or to the end of a file (the Home and
  239.                     End keys, respectively), to the succeeding or
  240.                     previous screen (PgUp and PgDn), or to move
  241.                     up or down a line at a time (Up Arrow or Down
  242.                     Arrow).  To return to DOS, simply press the
  243.                     Escape key or Ctrl-Break.
  244.  
  245.                     Wide displays, e.g. a spreadsheet file, are
  246.                     not broken at 80 columns, as with TYPE.
  247.                     BROWSE ignores carriage returns (ASCII 13),
  248.                     breaking lines only on line feeds (ASCII 10).
  249.                     The Right Arrow key scrolls the display to
  250.                     the right in eight-character increments (see
  251.                     Note 3 below) to view wide displays; the Left
  252.                     Arrow key returns you immediately to column
  253.                     zero.
  254.  
  255.                     BROWSE expands tab characters (ASCII 9) to
  256.                     the next eight-character boundary, but does
  257.                     no other character processing unless the /W
  258.                     parameter is specified.  Use of the /W option
  259.                     permits using BROWSE with WordStar files.
  260.  
  261.                     Notes:
  262.  
  263.                     1.   BROWSE can run under TopView or Windows;
  264.                          specify "writes directly to screen" in
  265.                          the .PIF and use the default 52K memory
  266.                          requirement.  (The program actually
  267.                          requires only approximately 33K to run.)
  268.                          For the TopView PIF, specify that the
  269.                          program intercepts Interrupt 23h.
  270.  
  271.                     2.   BROWSE is compatible with the IBM
  272.                          monochrome, CGA, and EGA displays, and
  273.  
  274.  
  275.  
  276.  
  277.                                  Page -4-
  278.                          will even run in the EGA 43-line mode.
  279.                          Files prepared with word-processors that
  280.                          employ a one-line-per-paragraph format
  281.                          (such as Microsoft Word and XyWrite) may
  282.                          to require excessive right scrolling,
  283.                          however.
  284.  
  285.                     3.   BROWSE.COM can be patched with DEBUG so
  286.                          that its right-scroll jumps by more than
  287.                          the default eight characters.  The
  288.                          address to patch is 10F in the .COM
  289.                          file.  After entering DEBUG BROWSE.COM
  290.                          type
  291.  
  292.                               E 10F
  293.  
  294.                          and the default value (08h) will appear.
  295.                          Type the desired hexadecimal number (28
  296.                          for a 40-column increment; 50 for an 80-
  297.                          column increment) and press <Enter>.
  298.                          Then type W<Enter> to write to the disk
  299.                          and Q<Enter> to quit DEBUG.
  300.  
  301.                     4.   Requires DOS 2.0 or later.
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.                                  Page -5-
  341.  
  342.           COLORSET (Automatic Color Setter)      Charlie Butrico
  343.           Command                                          No. 4
  344.  
  345.           ______________________________________________________
  346.  
  347.           Purpose:  Memory-resident utility that sets the
  348.                     foreground, background, and border colors on
  349.                     color systems, and prevents attempts by
  350.                     applications software to reset these colors
  351.                     to gray-on-black.
  352.  
  353.           Format:   [d:][path]COLORSET FG/BG BORD
  354.  
  355.           Remarks:  While dozens of small programs can set your
  356.                     screen colors, many popular programs (such as
  357.                     dBASE II) will reset them to a drab gray-on-
  358.                     black.  The first time you execute COLORSET,
  359.                     it will set your colors, remain in memory,
  360.                     look for such resetting instructions, and
  361.                     will instead set the colors to the ones you
  362.                     specified. Later executions of COLORSET will
  363.                     update the attributes only.
  364.  
  365.                     FG/BG is the foreground and background color
  366.                     (a decimal number from 0 to 255).  To
  367.                     calculate FG/BG, multiply the number of the
  368.                     background color by 16 and add the number of
  369.                     the foreground color to it.
  370.  
  371.           Example:  The FG/BG number for blue text on a white
  372.                     background is 113, i.e., ( (7*16) + 1 ).
  373.  
  374.                     The number for red text on a cyan background
  375.                     is 52, i.e., ( (3*16) + 4 ).
  376.  
  377.                     BORD is the border number (a decimal number
  378.                     from 0 to 15).
  379.  
  380.                     Keying just one number or using COLORSET on
  381.                     an EGA will change only the foreground and
  382.                     background colors.
  383.  
  384.                     After running COLORSET, the DOS CLS command
  385.                     will clear the screen to the colors you chose
  386.                     rather than to the default DOS gray-on-black.
  387.  
  388.                     Notes:
  389.  
  390.                     1.   DOS does not permit you to use bright
  391.                          background colors; trying a FG/BG number
  392.                          higher than 127 will produce text that
  393.                          blinks.
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.                                  Page -6-
  404.  
  405.                     2.   ======== COLOR CHART =========
  406.  
  407.                          0-Black        8-Gray
  408.                          1-Blue         9-Bright Blue
  409.                          2-Green       10-Bright Green
  410.                          3-Cyan        11-Bright Cyan
  411.                          4-Red         12-Bright Red
  412.                          5-Magenta     13-Bright Magenta
  413.                          6-Brown       14-Yellow
  414.                          7-White       15-Bright White
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                  Page -7-
  467.  
  468.           DDIR (Double Directory)                Charles Petzold
  469.           Command                                          No. 5
  470.  
  471.           _______________________________________________________
  472.  
  473.           Purpose:  Displays all (or selected) directory entries
  474.                     in double columns, sorted in alphabetical
  475.                     order.
  476.  
  477.           Format:   DDIR [d:][path][filename[.ext]]
  478.  
  479.           Remarks:  If no parameters are specified, DDIR will
  480.                     list all files in the current directory.  Use
  481.                     of the global characters ? and * in the
  482.                     filename and extension parameters is
  483.                     supported.
  484.  
  485.                     If more than one screenful (50 entries) is
  486.                     required, the display pauses at the bottom,
  487.                     showing the message, "Press any key to
  488.                     continue."
  489.  
  490.                     Notes:
  491.  
  492.                     1.   Because DDIR.COM loads a secondary
  493.                          command processor, it will not operate
  494.                          under the Run option of WordStar and
  495.                          possibly with some other programs that
  496.                          normally allow calling up external
  497.                          programs.  For the same reason, it
  498.                          cannot be automatically reinvoked using
  499.                          the F3 key when at the DOS command
  500.                          level.
  501.  
  502.                     2.   Requires DOS 2.0 or later.
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.                                  Page -8-
  530.  
  531.           DELZ (Delete file entirely)             Steven Holzner
  532.           Command                                          No. 6
  533.  
  534.           _______________________________________________________
  535.  
  536.           Purpose:  Allows you to delete a file absolutely by
  537.                     writing over the sector(s) it occupies.
  538.  
  539.           Format:   DELZ
  540.  
  541.                     then
  542.  
  543.                     DEL/Z [d:][path][filename[.ext]]
  544.  
  545.           Remarks:  DOS does not delete files by overwriting
  546.                     them.  Rather, the sectors used by the
  547.                     "erased" file are simply made available for
  548.                     use by subsequently written files.  Until
  549.                     they are so used, however, the original file
  550.                     can be recovered with UNDEL.COM (included in
  551.                     these utilities) or by using a comparable
  552.                     commercial product.
  553.  
  554.                     Because it overwrites the sectors used by a
  555.                     file, DELZ provides complete deletion.  A
  556.                     memory-resident utility, it attaches itself
  557.                     to DOS when loaded, normally as a command
  558.                     entered through your AUTOEXEC.BAT file.
  559.                     Thereafter, until you reboot, it provides a
  560.                     /Z (for "zero out") option for the DEL
  561.                     command.
  562.  
  563.           Example:  The disk from which you boot up your PC on
  564.                     drive A: has a copy of DELZ.COM on it, and
  565.                     the disk in drive B: has a file called
  566.                     TAXCHEAT.85 that you wish to ensure is
  567.                     completely obliterated.  From the A> prompt
  568.                     you enter DELZ to load the command into
  569.                     memory.  Then you enter
  570.  
  571.                          DEL/Z B:TAXCHEAT.85
  572.  
  573.                     Even if the TAXCHEAT.85 file is unerased, its
  574.                     original contents will now be unrecoverable.
  575.                     (The contents of that file will, in fact, be
  576.                     the machine language code of DELZ.COM
  577.                     itself.)
  578.  
  579.                     Notes:
  580.  
  581.                     1.   The Z in DEL/Z must be typed uppercase.
  582.                          The use of the global characters ? and *
  583.                          is supported.
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.                                  Page -9-
  593.                     2.   Because of possible conflicts with other
  594.                          memory-resident programs and utilities,
  595.                          you must check whether DELZ can be
  596.                          installed on your own system.  While
  597.                          SideKick has caused no reported
  598.                          difficulties, running XyWrite II or III,
  599.                          with or without its XYKBD.COM file, is
  600.                          impossible after DELZ is made resident.
  601.  
  602.                     3.   The use of DELZ.COM is likely to be
  603.                          reasonably infrequent, but sometimes it
  604.                          will be absolutely necessary.  If you
  605.                          find at those times that co-residency
  606.                          conflicts prevent putting it in your
  607.                          AUTOEXEC.BAT file, you may wish to keep
  608.                          a bootable disk (formatted with the /S
  609.                          option) with a copy of DELZ.COM and an
  610.                          AUTOEXEC.BAT file that loads the
  611.                          program.  If you then boot up from this
  612.                          disk you can destroy any file(s) you
  613.                          wish, remove the DELZ disk, and reboot
  614.                          your computer normally.
  615.  
  616.                     4.   Requires DOS 2.0 or higher.
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.                                  Page -10-
  656.  
  657.           DISKSCAN                               Charles Petzold
  658.           Command                                          No. 7
  659.  
  660.           ______________________________________________________
  661.  
  662.           Purpose:  Locates and identifies disk errors on hard
  663.                     and floppy disks, Bernoulli Boxes or other
  664.                     similar storage devices.
  665.  
  666.           Format:   DISKSCAN [d:]
  667.  
  668.           Remarks:  The DOS "Abort, Retry, Ignore?" and the
  669.                     CHKDSK "x lost clusters found" messages tend
  670.                     to appear after it is too late to save
  671.                     possibly valuable data.  Regular use of
  672.                     DISKSCAN will show when a hard disk is
  673.                     beginning to go bad--for example, when a
  674.                     specific sector or two in an as-yet
  675.                     unallocated cluster has become unusable since
  676.                     the disk was formatted.  (DOS marks and does
  677.                     not use bad clusters it finds while
  678.                     formatting.  DISKSCAN reports these "Flagged
  679.                     as bad.")
  680.  
  681.                     DISKSCAN error messages include:
  682.  
  683.                     CRC Error: Data checksum as recalculated
  684.                          during read does not agree with checksum
  685.                          stored on disk when written.
  686.                     Sector Not Found: Sector boundary created
  687.                          during formatting is no longer readable.
  688.                     File Alloc. Table and Can't Read FAT: Very
  689.                          serious error:  Back up what you can
  690.                          with COPY and reformat disk before
  691.                          trying to put files back on it.
  692.                     Boot Sector:  If this sector of a hard disk
  693.                          goes bad, put a DOS disk in drive A: and
  694.                          issue SYS C: command.  Then COPY
  695.                          COMMAND.COM C:.  This will put a fresh
  696.                          copy of the system files on drive C:.
  697.                          If this does not work, boot up again
  698.                          from the external DOS floppy disk, back
  699.                          up all hard disk files, and reformat the
  700.                          hard disk.
  701.                     Root Directory:  Errors here could keep you
  702.                          from later being able to load a file or
  703.                          save updates to it.  CHKDSK will
  704.                          probably indicate unallocated cluster
  705.                          chains or cross-linked files, and you
  706.                          may have to use CHKDSK/F to save what
  707.                          you can.
  708.                     Unallocated:  As yet, not serious, as the bad
  709.                          sector is not being used.  When it is,
  710.                          though, and you try to save a file with
  711.                          this sector, you'll get an "Abort,
  712.                          Retry, Ignore" message.  Select "Ignore"
  713.                          to save what you can, then REName the
  714.  
  715.  
  716.  
  717.  
  718.                                  Page -11-
  719.                          file and save again under the new name.
  720.                          Use RECOVER filename with the original
  721.                          file; this will cause DOS to flag its
  722.                          cluster(s) as bad.  (DISKSCAN does not
  723.                          enter the bad cluster numbers in the
  724.                          File Allocation Table; FORMAT and
  725.                          RECOVER do.)  Then delete the original
  726.                          (RECOVERed) filename and check the
  727.                          second version you saved (under the new
  728.                          name) to see how much (if any) of it is
  729.                          usable.
  730.                     Used by file: While DISKSCAN reports the bad
  731.                          sector number, it does not do a cross-
  732.                          check to see which of your files is
  733.                          using that sector.  You may be able to
  734.                          identify this by issuing the command
  735.  
  736.                               SWEEP COPY *.* NUL
  737.  
  738.                          When COPY encounters the file with the
  739.                          bad sector it will report "Abort, Retry,
  740.                          Ignore."  Note the bad file and press
  741.                          "I" to continue.
  742.                     Read Fault and General Failure:  The sectors
  743.                          so designated are bad, but the errors
  744.                          reported don't fall into any of the
  745.                          above categories.
  746.  
  747.                     Notes:
  748.  
  749.                     1.   Requires DOS 2.0 or higher.
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.                                  Page -12-
  782.  
  783.           DOORS                                   John Dickinson
  784.           Command                                          No. 8
  785.  
  786.           ______________________________________________________
  787.  
  788.           Purpose:  Permits switching between two simultaneously
  789.                     connected displays without leaving an
  790.                     application program and thereby losing the
  791.                     contents of the alternate screen.
  792.  
  793.           Format:   DOORS        (loads memory-resident program)
  794.                     <Alt-Right Shift>  (toggles between screens)
  795.  
  796.           Remarks:  When the second screen display is invoked by
  797.                     pressing Alt-Right Shift, DOORS begins by
  798.                     copying the first screen to the second.  The
  799.                     first screen display remains resident on that
  800.                     monitor, for reference, but the focus of your
  801.                     work shifts to the second screen, on which
  802.                     you may continue working.  If you then
  803.                     subsequently switch back to the first monitor
  804.                     (by pressing Alt-Right Shift again), the
  805.                     second monitor's current contents will remain
  806.                     on its display but will initially be copied
  807.                     to the first monitor.
  808.  
  809.                     Since the monochrome display cannot support
  810.                     40-column text or color graphics modes, DOORS
  811.                     can only be used with your color monitor set
  812.                     for 80-column text mode.  In addition to
  813.                     switching between monochrome and color text
  814.                     modes, however, DOORS permits you to store
  815.                     a screen from either a monochrome or a high-
  816.                     resolution EGA text display to the other 
  817.                     monitor, though you must toggle back to re-
  818.                     sume your work on the display from which 
  819.                     you started.
  820.  
  821.                     Notes:
  822.  
  823.                     1.   DOORS.COM may not work with
  824.                          "compatibles" that do not use the same
  825.                          keyboard interrupt structure as the PC.
  826.                          Further, as with all memory-resident
  827.                          software, it may not be compatible with
  828.                          all programs.
  829.  
  830.                     2.   Requires DOS 2.0 or later.
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.                                  Page -13-
  845.  
  846.           DOS-EDIT                               Charles Petzold
  847.           Command                                          No. 9
  848.  
  849.           ______________________________________________________
  850.  
  851.           Purpose:  Permits moving to, editing, and reentering
  852.                     on-screen DOS commands without retyping.
  853.  
  854.           Format:   DOS-EDIT     (loads memory-resident program)
  855.                          then
  856.                     <Up Arrow>           (enables DOS-Edit keys)
  857.                     <Left Arrow>                   (cursor left)
  858.                     <Right Arrow>                 (cursor right)
  859.                     <Up Arrow>                       (cursor up)
  860.                     <Down Arrow>                   (cursor down)
  861.                     <Backspace>          (destructive backspace)
  862.                     <Ins>              (insert/overwrite toggle)
  863.                     <Del>                     (delete character)
  864.                     <PgDn>               (delete to end of line)
  865.                     <PgUp>                  (cursor to column 1)
  866.                     <Home>          (cursor to initial column #)
  867.                     <Esc>           (exit edit mode, no changes)
  868.                     <End>           (transfer text line right of
  869.                                  cursor to end of original line)
  870.                     <Enter>   (like <End>, plus execute command)
  871.  
  872.           Remarks:  When loaded, normally through your
  873.                     AUTOEXEC.BAT file, an initial Up Arrow
  874.                     keypress activates the DOS-EDIT mode.
  875.                     (Thereafter, the Up Arrow functions as a
  876.                     normal cursor arrow key.)  If you move the
  877.                     cursor down to the original line, you will
  878.                     leave the DOS-EDIT mode (e.g., the Left Arrow
  879.                     key will once again delete characters).
  880.  
  881.           Example:  A typical use of DOS-EDIT is to correct a
  882.                     long command line in which you made a typing
  883.                     error.  Simply move the cursor up to the mis-
  884.                     typed line, correct the mistake (using the
  885.                     appropriate keys listed under FORMAT), press
  886.                     Home (to position the cursor to pick up the
  887.                     whole of the line), then Enter.
  888.  
  889.                     A less obvious example occurs if you have
  890.                     just done a DIR listing and want to run a
  891.                     program.  Move the cursor up and just to the
  892.                     right of the program name.  Press PgDn to
  893.                     delete the extension and the rest of the
  894.                     line, PgUp to position the cursor to pick up
  895.                     the whole command name, then Enter.
  896.  
  897.                     Note:
  898.  
  899.                     1.   DOS-EDIT is a memory-resident program,
  900.                          and so may cause conflicts with some
  901.                          other memory-resident software programs.
  902.                          Such problems can frequently be solved
  903.                          by changing the order in which the
  904.                          several memory-resident programs are
  905.                          loaded.   DOS-EDIT should be loaded
  906.                          before ASSIGN.COM and before SideKick,
  907.                          for example.
  908.                                  Page -14-
  909.  
  910.           FREE                                       Art Merrill
  911.           Command                                         No. 10
  912.  
  913.           ______________________________________________________
  914.  
  915.           Purpose:  FREE.COM reports the number of unallocated
  916.                     bytes on a floppy or hard disk.
  917.  
  918.           Format:   FREE [d:]
  919.  
  920.           Remarks:  FREE is in many respects a companion program
  921.                     to SIZE.COM:  the latter tells you how much
  922.                     storage space you must have to make your
  923.                     copies, the former tells you how much you do
  924.                     have.
  925.  
  926.                     The information provided by FREE.COM is, of
  927.                     course, available with the DOS commands
  928.                     CHKDSK and DIR.  Where a large group of files
  929.                     is involved, however, the DOS commands are
  930.                     very slow in operation;  FREE is almost
  931.                     instantaneous.
  932.  
  933.                     Notes:
  934.  
  935.                     1.   Requires DOS 2.0 or later.
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.                                  Page -15-
  969.  
  970.              KEEPER                                  Steven Holzner
  971.           Command                                         No. 11
  972.  
  973.           ______________________________________________________
  974.  
  975.           Purpose:  Stores and displays the last ten commands
  976.                     entered for immediate reexecution without
  977.                     retyping.
  978.  
  979.           Format:   KEEPER       (loads memory-resident program)
  980.                     <Ctrl-N>            (toggles window display)
  981.  
  982.           Remarks:  KEEPER can store command lines of up to 50
  983.                     characters each in length.  After loading,
  984.                     normally via your AUTOEXEC.BAT file, and
  985.                     pressing Ctrl-N (the default trigger key; see
  986.                     Option 1), the last 10 command lines are
  987.                     shown in a window in the upper right-hand
  988.                     corner of the display.  If you wish to
  989.                     execute one of the commands shown, move to
  990.                     its line with the Up Arrow and Down Arrow
  991.                     keys;  the line currently selected blinks.
  992.                     Pressing Ctrl-N again will reissue a blinking
  993.                     command or, if no stored command line has
  994.                     been selected, will return the display to
  995.                     normal.
  996.  
  997.                     Notes:
  998.  
  999.                     1.   KEEPER is not compatible with a number
  1000.                          of application programs (e.g., XyWrite)
  1001.                          that take over the keyboard interrupts.
  1002.  
  1003.  
  1004.           Option 1: The default trigger key is Ctrl-N.  Should
  1005.                     this be inconvenient, you can use the
  1006.                     KEEPER.BAS program to recreate KEEPER.COM
  1007.                     with a different trigger key.  From the DOS
  1008.                     prompt simply enter
  1009.  
  1010.                          BASIC KEEPER
  1011.  
  1012.                          and the program will prompt you for your
  1013.                     choice of trigger key.  After the KEEPER.COM
  1014.                     file is created in this way, it is a regular
  1015.                     DOS command and is not run under BASIC.
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.                                  Page -16-
  1032.  
  1033.           KEY-FAKE                               Charles Petzold
  1034.           Command                                         No. 12
  1035.  
  1036.           ______________________________________________________
  1037.  
  1038.           Purpose:  Supplies the series of keystrokes needed to
  1039.                     initialize an application program on boot-up.
  1040.  
  1041.           Format:   KEY-FAKE ["xyz"] [nn] [0] [@F]
  1042.                     Programname
  1043.  
  1044.                     Characters typed within a pair of single or
  1045.                     double quotes ("xyz") are normal ASCII-
  1046.                     character keystrokes.  Numbers (nn) not in
  1047.                     quote marks are ASCII decimal codes, e.g., 13
  1048.                     (Enter), 26 (Ctrl-Z), or 27 (Esc).  Numbers
  1049.                     preceded by @ are the extended ASCII decimal
  1050.                     codes (128 through 255) generated by the Alt
  1051.                     keys, cursor keys, Ins and Del keys, and the
  1052.                     Function keys (e.g., @61 is the F3
  1053.                     keystroke).  The 0 is used with programs that
  1054.                     check the keyboard buffer (it tells such
  1055.                     programs the buffer is clear, so the programs
  1056.                     will treat the succeeding keystroke
  1057.                     separately).
  1058.  
  1059.           Remarks:  KEY-FAKE is of greatest use in batch files
  1060.                     used to call up application programs.  For
  1061.                     example, to enter Lotus's 1-2-3 and set it
  1062.                     for File Retrieve, the following .BAT file
  1063.                     would be appropriate:
  1064.  
  1065.                     CD \LOTUS
  1066.                     KEY-FAKE 0 13 0 13 0 13 0 13 0 13 "/FR"
  1067.                     LOTUS
  1068.  
  1069.                     This takes you past the necessary initial
  1070.                     carriage returns and /FR command without
  1071.                     having to type them in each time.
  1072.  
  1073.                     Similarly, if each time you enter BASICA you
  1074.                     want to have a blue border, blue background,
  1075.                     and yellow letters, you would create a batch
  1076.                     file, B.BAT, containing the lines
  1077.  
  1078.                     KEY-FAKE "COLOR 14,1,1" 13 "CLS" 13
  1079.                     BASICA
  1080.  
  1081.                     Notes:
  1082.  
  1083.                     1.   The keystroke sequence stored by KEY-
  1084.                          FAKE is limited to 124 characters and
  1085.                          must be on one continuous command line.
  1086.                          Keystrokes not supported by PC BIOS
  1087.                          (e.g., Alt-Home) cannot be stored.
  1088.  
  1089.                     2.   Programs such as XyWrite II that get
  1090.                          keyboard information directly from the
  1091.                          hardware keyboard interrupt will bypass
  1092.                          KEY-FAKE.  KEY-FAKE will also not work
  1093.                          well when you are on-line using a
  1094.                          communications program.
  1095.                                  Page -17-
  1096.  
  1097.                     3.   KEY-FAKE is memory resident, but can be
  1098.                          executed multiple times in the same
  1099.                          session without reloading.  However, if
  1100.                          nested batch files cause it to be re-
  1101.                          invoked before its initially stored
  1102.                          keystroke sequence has been exhausted,
  1103.                          the remaining initial keystrokes will be
  1104.                          lost.
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.                                  Page -18-
  1159.  
  1160.           LOCATE                                  Steven Holzner
  1161.           Command                                         No. 13
  1162.  
  1163.           ______________________________________________________
  1164.  
  1165.           Purpose:  Searches all files in the current and the
  1166.                     root directories of a drive for all
  1167.                     occurrences of any specified sequence (e.g.,
  1168.                     a word or phrase) of up to 20 ASCII
  1169.                     characters. Additional search paths and/or
  1170.                     drives may be specified by using Option 1.
  1171.  
  1172.           Format:   LOCATE searchstring
  1173.  
  1174.           Remarks:  In addition to returning the path(s) and
  1175.                     filename(s) of the file(s) in which the
  1176.                     requested string is found, LOCATE puts
  1177.                     searchstring into a context of up to 20
  1178.                     immediately surrounding characters.
  1179.  
  1180.                     LOCATE.COM is case sensitive;  the string to
  1181.                     be found must be typed exactly.  The program
  1182.                     does, however, strip "high-order" (non-ASCII)
  1183.                     bits from searchstring, so it can be used,
  1184.                     for example with WordStar document files.
  1185.  
  1186.                     Note:
  1187.  
  1188.                     1.   Requires the use of DOS 2.0 or later.
  1189.  
  1190.           Option 1: Normally, if LOCATE does not find the
  1191.                     requested string either in the current
  1192.                     directory or in the disk's root directory, it
  1193.                     simply exits.  It does not automatically
  1194.                     search every subdirectory on every drive.
  1195.  
  1196.                     You can extend the search range, however, by
  1197.                     preparing a simple ASCII file that specifies
  1198.                     additional paths and/or drives.  The name of
  1199.                     this file must be PATH.DAT, and it must be
  1200.                     located in the root directory (usually C:\
  1201.                     for hard disks, A:\ for floppies).  An
  1202.                     example of such a PATH.DAT file would be
  1203.  
  1204.                     \WORK
  1205.                     \LEVEL1
  1206.                     \A:
  1207.  
  1208.                     Each line in the PATH.DAT file must end with
  1209.                     a carriage return and specifies an additional
  1210.                     path (or drive) for LOCATE to check before it
  1211.                     exits.  The PATH.DAT file can be up to 300
  1212.                     bytes in length, and incorrectly specified
  1213.                     entries are ignored.
  1214.  
  1215.                     The use of Option 1 will, of course, slow
  1216.                     down the overall speed of the search.
  1217.  
  1218.  
  1219.  
  1220.  
  1221.                                  Page -19-
  1222.                       
  1223.           LOCK (and UNLOCK)                       Steven Holzner
  1224.           Commands                                        No. 14
  1225.  
  1226.           ______________________________________________________
  1227.  
  1228.           Purpose:  Encrypts a file, rendering it unreadable to
  1229.                     anyone who does not know the user-chosen
  1230.                     passphrase.  Complementarily, using the same
  1231.                     passphrase, de-encrypts the file.
  1232.  
  1233.           Format:   LOCK [d:][path]filename[.ext] [d:][path]
  1234.                     [filename][.ext]
  1235.                                  or
  1236.                     UNLOCK [d:][path]filename[.ext] [d:][path]
  1237.                     [filename][.ext]
  1238.  
  1239.           Remarks:  The user-selected passphrase can be up to 64
  1240.                     characters in length; the programs prompt you
  1241.                     to supply it.  Files to be LOCKed and
  1242.                     UNLOCKed must be less than 62K in length.  If
  1243.                     you do not supply new filenames for the
  1244.                     locked and unlocked files, the programs use
  1245.                     the default filename FILE.LOC.
  1246.  
  1247.           Example:  You have a file of student course evaluations
  1248.                     named CONFY on drive C: that you wish to mail
  1249.                     to a colleague in encrypted form.  You put a
  1250.                     formatted floppy disk in drive A:, and at the
  1251.                     C> prompt you enter
  1252.  
  1253.                          LOCK CONFY A:CRIMSON
  1254.  
  1255.                     When the program asks for a passphrase, you
  1256.                     enter VERITAS.
  1257.  
  1258.                     The CRIMSON file on the disk will be
  1259.                     unreadable.  When your colleague--who must,
  1260.                     of course, be told the passphrase you have
  1261.                     used--puts the disk in his machine, he types
  1262.  
  1263.                          UNLOCK CRIMSON GUIDE
  1264.  
  1265.                     When prompted, he supplies the passphrase
  1266.                     VERITAS, and his file GUIDE will be identical
  1267.                     to your original file CONFY.
  1268.  
  1269.                     Notes:
  1270.  
  1271.                     1.   LOCK and UNLOCK do not delete any files,
  1272.                          original or encoded.
  1273.  
  1274.                     2.   Requires DOS version 2.0 or later.
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.                                  Page -20-
  1285.  
  1286.           LPTPORT                                 John Dickinson
  1287.           Command                                         No. 15
  1288.  
  1289.           _______________________________________________________
  1290.  
  1291.           Purpose:  Permits alternate use of two parallel
  1292.                     printers (e.g., letter- and draft-quality
  1293.                     units) with software that is normally limited
  1294.                     to using LPT1:.
  1295.  
  1296.           Format:   LPTPORT
  1297.  
  1298.           Remarks:  Certain software, e.g., the PC-DOS Shift-
  1299.                     PrtSc routine, does not recognize a command
  1300.                     such as
  1301.  
  1302.                     A>MODE LPT1:=LPT2:
  1303.  
  1304.                     To use such software with two different
  1305.                     printers normally requires changing physical
  1306.                     connections.
  1307.  
  1308.                     LPTPORT.COM provides a software toggle that
  1309.                     interchanges the internal DOS I/O addresses
  1310.                     of LPT1: and LPT2:.  After entering the
  1311.                     LPTPORT command, a second printer, connected
  1312.                     to LPT2:, will receive program output
  1313.                     nominally directed to LPT1:.  Entering the
  1314.                     LPTPORT command a second time restores the
  1315.                     original port assignments.
  1316.  
  1317.                     Notes:
  1318.  
  1319.                     1.   Certain internal print-spooling
  1320.                          programs, such as those supplied with
  1321.                          add-on memory board cards, read the port
  1322.                          address assignments at boot-up time and
  1323.                          do not thereafter look at the low-memory
  1324.                          area of DOS to find them.  With such
  1325.                          programs you will have to run LPTPORT
  1326.                          before the print spoolers are loaded in
  1327.                          order to change the effective port
  1328.                          assignments.
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.                                  Page -21-
  1348.  
  1349.           MONOGRAF.DRV                           Charles Petzold
  1350.           Lotus's 1-2-3 (Version 1A) driver               No. 16
  1351.  
  1352.           ______________________________________________________
  1353.  
  1354.           Purpose:  Displays 1-2-3 bar and stacked-bar graphs on
  1355.                     a monochrome monitor.
  1356.  
  1357.           Format:   COPY MONOGRAF.DRV [drive:][path] GD.DRV
  1358.  
  1359.                     Note: the [drive:] and [path] above refer to
  1360.                     your Lotus system disk or subdirectory path.
  1361.             
  1362.                     Note also:  When using MONOGRAF, specify
  1363.                     Color, not Black-and-White, from the 1-2-3
  1364.                     graph options menu.
  1365.  
  1366.           Remarks:  Displaying the numbers in a 1-2-3 worksheet
  1367.                     in graph form normally requires using either
  1368.                     a color/graphics adaptor (CGA) and monitor
  1369.                     or--for users who have only a monochrome
  1370.                     system--the use of a Hercules (or equivalent)
  1371.                     card.
  1372.  
  1373.                     MONOGRAF.DRV is installed in 1-2-3 just as if
  1374.                     it were a Lotus-supplied GD (graphics driver)
  1375.                     program.
  1376.  
  1377.                     Notes:
  1378.  
  1379.                     1.   MONOGRAF can display only bar or
  1380.                          stacked-bar graphs.
  1381.  
  1382.                     2.   To display graphs, use Function key 10,
  1383.                          as the Lotus manual directs.  Use this
  1384.                          key only in the Worksheet mode, not in
  1385.                          conjunction with the 1-2-3 PrintGraph
  1386.                          program.  You can, however, use Shift-
  1387.                          PrtSc to print out the screen display on
  1388.                          any printer that can handle the IBM
  1389.                          text-graphics character set.
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.                                  Page -22-
  1411.  
  1412.           MOVE                                    Steven Holzner
  1413.           Command                                         No. 17
  1414.  
  1415.           ______________________________________________________
  1416.  
  1417.           Purpose:  Allows rapid selection and copying of files
  1418.                     to or from a double-sided floppy disk, a
  1419.                     RAMdisk, or the current subdirectory of a
  1420.                     hard disk.
  1421.  
  1422.           Format:   MOVE [d:]filename[.ext] d:
  1423.  
  1424.           Remarks:  MOVE.COM was written to be compatible with
  1425.                     all versions of PC-DOS (including 1.1), and
  1426.                     so does not support pathnames.
  1427.  
  1428.           Example:  When you enter a command such as
  1429.  
  1430.                          MOVE A:*.BAS B:
  1431.  
  1432.                     each filename on the root (or current)
  1433.                     directory of drive A: that has a .BAS
  1434.                     extension will be displayed in the form
  1435.  
  1436.                     Copy filename.BAS (Y/N)?
  1437.  
  1438.                     If you strike Y, the file will immediately be
  1439.                     copied to drive B: and the next appropriate
  1440.                     filename will be displayed.  If you strike N,
  1441.                     the file will not be copied, and the next
  1442.                     appropriate filename will be presented.  The
  1443.                     program terminates with a simple return to
  1444.                     the DOS prompt when no appropriate files
  1445.                     remain to be considered.
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.                                  Page -23-
  1474.  
  1475.           NO                                     Charles Petzold
  1476.           Command                                         No. 18
  1477.  
  1478.           ______________________________________________________
  1479.  
  1480.           Purpose:  Excludes specified files in a subdirectory
  1481.                     from the action of a command.
  1482.  
  1483.           Format:   NO filespec Command [parameter]
  1484.  
  1485.           Remarks:  NO.COM is designed for situations in which
  1486.                     you want to apply a command such as DELete or
  1487.                     COPY to all the files in a directory except
  1488.                     one or two (or a class of) files.  For
  1489.                     example,
  1490.  
  1491.                          NO *.BAS COPY *.* A:
  1492.  
  1493.                     copies all the files in your current
  1494.                     subdirectory to drive A: except for those
  1495.                     that have a .BAS extension.
  1496.  
  1497.                     To exclude more than one file (or category)
  1498.                     you must use a separate NO command for each
  1499.                     on the command line.  Thus,
  1500.  
  1501.                          NO *.ASM NO *.COM DEL *.*
  1502.  
  1503.                     deletes all files in the current directory
  1504.                     except those with .ASM or .COM extensions.
  1505.  
  1506.                     Notes:
  1507.  
  1508.                     1.   NO.COM should not be used in conjunction
  1509.                          with the PC-DOS BACKUP and RESTORE
  1510.                          commands.  This is because NO operates
  1511.                          by temporarily setting the "hidden" file
  1512.                          attribute bit on the files to be
  1513.                          excluded from the main command, then
  1514.                          unhiding the files after the main
  1515.                          command has been executed.  Since the
  1516.                          DOS BACKUP/RESTORE operation acts on
  1517.                          hidden and unhidden files alike, NO.COM
  1518.                          cannot be used to exclude files from
  1519.                          BACKUP/RESTORE.  RESTORE, indeed, will
  1520.                          restore the supposedly excluded files as
  1521.                          hidden, overwriting the originals.
  1522.  
  1523.                     2.   While NO.COM provides full path support
  1524.                          (and so requires the use of DOS 2.0 or
  1525.                          later), it is a good policy when using
  1526.                          NO to use CHDIR to make the directory
  1527.                          that contains the files on which you
  1528.                          wish to operate the current directory.
  1529.  
  1530.                          For example, suppose you are in your
  1531.                          root directory, one of whose subdirec-
  1532.                          tories is \BASIC.  If you were to enter
  1533.                          the command
  1534.  
  1535.                               NO *.BAS DEL \BASIC\*.*
  1536.  
  1537.                                  Page -24-
  1538.                          you would not delete all the files in
  1539.                          the \BASIC subdirectory except those
  1540.                          with a .BAS extension, as you might have
  1541.                          intended to do.  To do this from the
  1542.                          root directory you would have had to
  1543.                          enter
  1544.  
  1545.                               NO \BASIC\*.BAS DEL \BASIC\*.*
  1546.  
  1547.                          This complete filespec would tell NO
  1548.                          that it had to protect files in the
  1549.                          \BASIC, not in the current (i.e., root)
  1550.                          directory.
  1551.  
  1552.                          If you follow our recommendation and
  1553.                          enter
  1554.  
  1555.                               CD \BASIC
  1556.                               NO *.BAS DEL *.*
  1557.  
  1558.                          thus making \BASIC your current
  1559.                          directory before you start deleting, you
  1560.                          will then clean out all but the .BAS
  1561.                          files, just as you intended.
  1562.  
  1563.                     3.   Should a parity check error, power
  1564.                          outage, or system crash occur during the
  1565.                          brief period between the times NO hides
  1566.                          and subsequently unhides the protected
  1567.                          files, those files will subsequently
  1568.                          seem to have disappeared.  They are not
  1569.                          lost; only hidden from a DIR listing.
  1570.                          Use ATTR.COM (included in this set of
  1571.                          utilities) to change their hidden
  1572.                          status.
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.                                  Page -25-
  1601.  
  1602.           NPAD (Notepad)                          Steven Holzner
  1603.           Command                                         No. 19
  1604.  
  1605.           ______________________________________________________
  1606.  
  1607.           Purpose:  Creates an on-screen window in which to keep
  1608.                     notes while working in other programs.
  1609.  
  1610.           Format:   NPAD         (loads memory-resident program)
  1611.                     <Ctrl-N>            (toggles notepad on/off)
  1612.  
  1613.           Remarks:  The NPAD notepad holds 10 lines of 25
  1614.                     characters each.  The window is toggled on
  1615.                     and off in the upper right corner of the
  1616.                     screen.  Toggling the window off does not
  1617.                     eliminate its contents, but pressing the
  1618.                     Delete key while the window is on-screen
  1619.                     does.  Single characters may be deleted with
  1620.                     the backspace, and the carriage return is
  1621.                     also recognized.  No provision for storing
  1622.                     the contents of the notepad as a file are
  1623.                     available, however.
  1624.  
  1625.                     Option 1: NPAD.COM can be modified by using
  1626.                     DEBUG.  The ASCII and scan codes for the
  1627.                     default trigger key (Ctrl-N) are 0Eh and 31h,
  1628.                     respectively, and are located at the offset
  1629.                     addresses xxxx:0336 and xxxx:0337.  To change
  1630.                     these to use the reverse apostrophe (grave
  1631.                     accent), you would enter
  1632.  
  1633.                          DEBUG NPAD.COM
  1634.  
  1635.                     and
  1636.  
  1637.                          -E 336
  1638.  
  1639.                     DEBUG will respond with
  1640.  
  1641.                     xxxx:0336  0E.
  1642.  
  1643.                     and you simply type in the new ASCII code, in
  1644.                     this case, 60 (the hex value of decimal 96).
  1645.  
  1646.                     After entering E 337 and getting the response
  1647.  
  1648.                     xxxx:0337  31.
  1649.  
  1650.                     you type in the new scan code 29 (41 decimal)
  1651.                     for the grave accent.  Other ASCII and scan
  1652.                     codes are given in the BASIC and in the DOS
  1653.                     Technical Reference manuals.
  1654.  
  1655.                     The two locations to examine and change for
  1656.                     the NPAD colors are 02FF and 0413, which have
  1657.                     a default value of 70h (112 decimal).  On a
  1658.                     color monitor this produces a white (7)
  1659.                     background with black (0) characters.  For
  1660.                     red letters on white you would change the 70h
  1661.                     to 74h (116 decimal) at these two locations.
  1662.  
  1663.                                  Page -26-
  1664.                     The colors to which NPAD resets its portion
  1665.                     of the screen on exit are set by the value at
  1666.                     xxxx:0350h.  The default value is 07 (white
  1667.                     characters on a black background).  For white
  1668.                     letters on a dark blue background, change the
  1669.                     07 to 17h (23 decimal); for dark blue letters
  1670.                     on white, use 71h (113 decimal) at this location.
  1671.  
  1672.                     When you have made the changes you want, at
  1673.                     the DEBUG hyphen prompt enter W and then Q.
  1674.  
  1675.                     Notes:
  1676.  
  1677.                     1.   NPAD is a memory-resident program that
  1678.                          must scan the keyboard interrupts.  It
  1679.                          will conflict with applications programs
  1680.                          (e.g., XyWrite) that themselves
  1681.                          commandeer the keyboard interrupts.
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.                                  Page -27-
  1727.  
  1728.           ONEKEY                                  Steven Holzner
  1729.           Command (after running .BAS version)            No. 20
  1730.  
  1731.           ______________________________________________________
  1732.  
  1733.           Purpose:  Reassigns a designated series of keystrokes
  1734.                     to a user-selected keystroke.
  1735.  
  1736.           Format:   ONEKEY
  1737.  
  1738.           Remarks:  ONEKEY is a memory-resident keyboard macro
  1739.                     program.  While written in assembly language,
  1740.                     it is presented here with a BASIC interface
  1741.                     that need be run only once, but which
  1742.                     facilitates entering the trigger keys you
  1743.                     want to use and the sequences of keystrokes
  1744.                     they will replace.  ONEKEY will accept up to
  1745.                     30 different trigger keys, each of which will
  1746.                     replace up to 50 keystrokes.
  1747.  
  1748.                     When you load and run ONEKEY.BAS in BASIC,
  1749.                     you will prompted to "Type the key to be
  1750.                     replaced."  This will be a key you use as a
  1751.                     trigger:  Ctrl-N, Alt-Z, F1, or the like.
  1752.                     When you enter this key, you will be
  1753.                     prompted, "The command that replaces this key
  1754.                     is."  Here you enter the string of keystrokes
  1755.                     the selected trigger key will execute.
  1756.                     Remember to include all necessary carriage
  1757.                     returns, spaces, and control characters, just
  1758.                     as you would enter them at the keyboard.
  1759.                     When you type Ctrl-End (not a carriage
  1760.                     return) to terminate this sequence, you'll be
  1761.                     prompted for the next trigger key, and so on.
  1762.  
  1763.                     When you have typed in as many macros as you
  1764.                     want, type Ctrl-End when asked for a trigger
  1765.                     key.  It takes BASIC about half a minute to
  1766.                     create the ONEKEY.COM file.
  1767.  
  1768.                     Once created, ONEKEY is a regular DOS
  1769.                     command;  you enter it at the DOS prompt (or
  1770.                     as a line in your AUTOEXEC.BAT file), not
  1771.                     from BASIC.
  1772.  
  1773.                     Notes:
  1774.  
  1775.                     1.   Memory-resident utilities such as ONEKEY
  1776.                          are often incompatible with programs
  1777.                          (XyWrite is one) that themselves take
  1778.                          over the keyboard interrupts.  You must
  1779.                          simply experiment to see if ONEKEY can
  1780.                          be used with your software.
  1781.  
  1782.                     2.   Requires DOS 2.0 or later.
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.                                  Page -28-
  1790.  
  1791.           PR (Print)                              John Dickinson
  1792.           Command                                         No. 21
  1793.  
  1794.           ______________________________________________________
  1795.  
  1796.           Purpose:  Prints the standard ASCII files of program
  1797.                     listings according to a standard formatted
  1798.                     style.
  1799.  
  1800.           Format:   PR [d:][path]filename[.ext]
  1801.  
  1802.           Remarks:  PR.COM formats the program listing into 80
  1803.                     columns, expands ASCII tabs, adds a seven-
  1804.                     line header and a blank footer, and prints 55
  1805.                     lines of the listing on each 66-line page.
  1806.                     The header contains the filename, page
  1807.                     number, and date and time the program was
  1808.                     last saved.
  1809.  
  1810.                     Notes:
  1811.  
  1812.                     1.   The listings photoreproduced in PC
  1813.                          Magazine's Programming/Utilities column
  1814.                          are printed using PR.COM.
  1815.  
  1816.                     2.   Requires use of DOS 2.0 or later.
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.                                  Page -29-
  1853.  
  1854.           PRSWAP                                  John Dickinson
  1855.           Command                                         No. 22
  1856.  
  1857.           ______________________________________________________
  1858.  
  1859.           Purpose:  Converts IBM text-graphics characters into
  1860.                     ASCII characters that can be printed by non-
  1861.                     graphics printers.
  1862.  
  1863.           Format:   PRSWAP
  1864.  
  1865.           Remarks:  The IBM text-graphics characters (non-
  1866.                     standard ASCII 176-223 and 254) programmers
  1867.                     often use to make their screen displays look
  1868.                     more attractive cannot be handled by many
  1869.                     printers.  PRSWAP.COM is a memory-resident
  1870.                     program that translates these characters into
  1871.                     presentable-looking ASCII substitutes.
  1872.  
  1873.                     PRSWAP should be loaded only once until you
  1874.                     power down or hit Ctrl-Alt-Del.  If you
  1875.                     intend to use it regularly, the best place to
  1876.                     put it is in your AUTOEXEC.BAT file.
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.                                  Page -30-
  1916.  
  1917.           PUSHDIR (and POPDIR)                       John Friend
  1918.           Commands                                        No. 23
  1919.  
  1920.           ______________________________________________________
  1921.  
  1922.           Purpose:  Provides a way to return automatically to
  1923.                     your current directory after running programs
  1924.                     that require directory changing.
  1925.  
  1926.           Format:   PUSHDIR
  1927.                     [CD \AltDir\ProgName]
  1928.                     POPDIR
  1929.  
  1930.           Remarks:  While PUSHDIR and POPDIR can be entered
  1931.                     directly from the DOS prompt, their primary
  1932.                     application is in batch files.  For example,
  1933.                     suppose you create a file named 12.BAT that
  1934.                     consists of the following four lines:
  1935.  
  1936.                          PUSHDIR
  1937.                          CD\LOTUS
  1938.                          123
  1939.                          POPDIR
  1940.  
  1941.                     Suppose also that 12.BAT, PUSHDIR.COM, and
  1942.                     POPDIR.COM are either in your root directory
  1943.                     or in a subdirectory on the PATH specified in
  1944.                     your AUTOEXEC.BAT file.  Assume, finally,
  1945.                     that you are currently in your word
  1946.                     processing subdirectory (\WP), but need some
  1947.                     information from a 1-2-3 spreadsheet.  If you
  1948.                     now enter
  1949.  
  1950.                          12<CR>
  1951.  
  1952.                     from the DOS prompt, PUSHDIR stores the \WP
  1953.                     (your current directory) on its stack and DOS
  1954.                     changes to the \LOTUS subdirectory and runs
  1955.                     1-2-3.  When you exit from 1-2-3, you would
  1956.                     normally be left in the \LOTUS subdirectory.
  1957.                     A DOS CD command in 12.BAT after the 123 line
  1958.                     could return you to a specified directory
  1959.                     every time you terminated 1-2-3, of course.
  1960.                     But POPDIR returns you to whatever
  1961.                     subdirectory you were in when you invoked 1-
  1962.                     2-3--in this case, to your \WP subdirectory.
  1963.  
  1964.                     PUSHDIR can accommodate up to six levels of
  1965.                     directories on its stack, permitting
  1966.                     considerable programming flexibility in
  1967.                     constructing batch files.
  1968.  
  1969.                     Notes:
  1970.  
  1971.                     1.   PUSHDIR and POPDIR require DOS 2.0 or
  1972.                          later.
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.                                  Page -31-
  1979.  
  1980.           QUICKEYS                                   Leo Forrest
  1981.           Command                                         No. 24
  1982.  
  1983.           ______________________________________________________
  1984.  
  1985.           Purpose:  Accelerates the "typematic" repeat rate of a
  1986.                     PC or XT keyboard.  A built-in subprogram is
  1987.                     included that instantly clears the keyboard
  1988.                     buffer to prevent sending excess accumulated
  1989.                     keystrokes to the display.
  1990.  
  1991.           Format:   QUICKEYS     (loads memory-resident program)
  1992.                     <Alt-Shift>         (clears keyboard buffer)
  1993.  
  1994.           Remarks:  While the keystroke repetition rate of the PC
  1995.                     AT is adjustable, that of the XT and the PC
  1996.                     is fixed at approximately nine keystrokes per
  1997.                     second.  When QUICKEYS is loaded (normally
  1998.                     through your AUTOEXEC.BAT file), the
  1999.                     repetition speed is approximately doubled.
  2000.                     Successive loadings of QUICKEYS (each
  2001.                     requires about 672 bytes of memory) can be
  2002.                     used to increase the keyboard speed still
  2003.                     further, if desired.
  2004.  
  2005.                     Notes:
  2006.  
  2007.                     1.   QUICKEYS is a memory-resident program
  2008.                          that inserts itself both into the timer
  2009.                          tick and keyboard interrupt routines.
  2010.                          It is not compatible with some other
  2011.                          memory-resident software and with
  2012.                          programs that appropriate the keyboard
  2013.                          interrupts.
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.                                  Page -32-
  2042.  
  2043.           RED (Redirect)                          John Dickinson
  2044.           Command                                         No. 25
  2045.  
  2046.           _______________________________________________________
  2047.  
  2048.           Purpose:  Transfers one (or more) file(s) from one
  2049.                     subdirectory to another without requiring the
  2050.                     use of COPY and ERASE.
  2051.  
  2052.           Format:   RED [d:][path]filename[.ext] [d:][path]
  2053.  
  2054.           Remarks:  Like the DOS COPY command, RED.COM supports
  2055.                     the use of the global characters ? and * in
  2056.                     specifying the desired source files.
  2057.  
  2058.                     Unlike COPY, however, RED.COM does not permit
  2059.                     renaming a file during the transfer process.
  2060.                     (This is why it is unnecessary to supply a
  2061.                     target filename.)  Furthermore, RED requires
  2062.                     that the source and target drives be the
  2063.                     same.  You cannot, therefore, remove a set of
  2064.                     files from drive C: by trying to REDirect
  2065.                     them to drive A:.
  2066.  
  2067.           Example:  Before submitting your income tax you
  2068.                     calculated it under several different
  2069.                     methods, contained in files named ROUGH1.DAT
  2070.                     through ROUGH6.WKS.  These are all in the
  2071.                     subdirectory \IRS on drive C:, and you want
  2072.                     to move them all to a sub-subdirectory (which
  2073.                     you have created) called \1985TAX\DRAFTS.
  2074.                     From the C> prompt enter
  2075.  
  2076.                          \IRS\ROUGH?.* \1985TAX\DRAFTS
  2077.  
  2078.                     and all six files will be moved out of \IRS
  2079.                     and into \1985\DRAFTS.
  2080.  
  2081.                     Note:
  2082.  
  2083.                     1.   Requires DOS 2.0 or later.
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.                                  Page -33-
  2105.  
  2106.           RENDIR (Rename Directory)               John Dickinson
  2107.           Command                                         No. 26
  2108.  
  2109.           ______________________________________________________
  2110.  
  2111.           Purpose:  Permits renaming subdirectories directly,
  2112.                     without creating a new directory, moving the
  2113.                     contents of the old one into it, and then
  2114.                     removing the old directory.
  2115.  
  2116.           Format:   RENDIR [d:][path]oldname[.ext] newname[.ext]
  2117.  
  2118.           Remarks:  PC-DOS has always provided a REName command
  2119.                     for filenames, but not for directories.  A
  2120.                     bug in DOS 3.0 permits you to use the
  2121.                     immediate mode of BASIC to
  2122.  
  2123.                          NAME olddir AS newdir
  2124.  
  2125.                     but this bug has been removed from subsequent
  2126.                     DOS versions.  RENDIR.COM permits renaming
  2127.                     directories in DOS 3.0 and later.
  2128.  
  2129.                     While RENDIR allows you to change the name of
  2130.                     a directory on another drive than your
  2131.                     current one, it does not permit you to
  2132.                     transfer a directory to another drive by
  2133.                     RENDIRing it.  Thus, for example, if you are
  2134.                     on drive C: and have a directory on drive D:
  2135.                     named \TAXES, from the C> prompt you can
  2136.  
  2137.                          RENDIR D:\TAXES \TAXES85
  2138.  
  2139.                     You cannot, however
  2140.  
  2141.                          RENDIR D:\TAXES C:\TAXES85
  2142.  
  2143.                     Furthermore, you should not use RENDIR to try
  2144.                     to change the name of the subdirectory you
  2145.                     are currently in.
  2146.  
  2147.                     Notes:
  2148.  
  2149.                     1.   Unlike RENAME, RENDIR does not support
  2150.                          use of the ? and * wildcard characters.
  2151.  
  2152.                     2.   Requires DOS 3.0 or higher.
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.                                  Page -34-
  2168.  
  2169.           SETUP                                     Jeff Prosise
  2170.           Command                                         No. 27
  2171.  
  2172.           ______________________________________________________
  2173.  
  2174.           Purpose:  Permits menu-oriented selection and immediate
  2175.                     transmission of printer control codes from
  2176.                     within a running application program.
  2177.  
  2178.           Format:   SETUP            (loads command into memory)
  2179.                     <Ctrl-Right Shift>          (activates menu)
  2180.                     <[Shift]<Fx>      (selects [deselects] mode)
  2181.                     <Esc>            (activates selection(s) and
  2182.                                  returns to application program)
  2183.  
  2184.                     Fx is a Function key (F1 through F10) that
  2185.                     sends the required control sequence to the
  2186.                     printer.  Shift-Fx toggles the selected
  2187.                     printer mode off.
  2188.  
  2189.           Remarks:  After loading SETUP (normally via your
  2190.                     AUTOEXEC.BAT file), the printer mode
  2191.                     selection menu program is displayed by
  2192.                     pressing the Ctrl-Right Shift key
  2193.                     combination.  This can be done from within
  2194.                     application programs that do not take over
  2195.                     the keyboard interrupts; the application is
  2196.                     simply suspended until you leave SETUP by
  2197.                     pressing the Esc key.  (Application programs
  2198.                     such as XyWrite III that do take over the
  2199.                     keyboard interrupts can be used with
  2200.                     SETUP.COM if they themselves provide the
  2201.                     option of temporarily returning to DOS
  2202.                     control.)
  2203.  
  2204.                     Printer permitting, more than one mode can be
  2205.                     selected at once by pressing additional
  2206.                     function keys.  The default printer choices
  2207.                     are for the Epson RX/FX series.  Option 1
  2208.                     shows how to modify the program for other
  2209.                     printers.
  2210.  
  2211.                     Notes:
  2212.  
  2213.                     1.   SETUP.COM is a memory-resident program
  2214.                          (approximately 3K in length), and so is
  2215.                          subject to conflicts with other memory-
  2216.                          resident software.  Several users have
  2217.                          reported that it is incompatible with
  2218.                          Prokey, for example.  Similarly, while
  2219.                          SETUP.COM is compatible with SideKick,
  2220.                          the combination of SuperKey and SideKick
  2221.                          has been reported to be incompatible.
  2222.  
  2223.           Option 1: If you have access to an IBM or Microsoft
  2224.                     macro assembler, the easiest way to modify
  2225.                     SETUP for other printers (or to use LPT2: or
  2226.                     LPT3: instead of LPT1:) is to call up the
  2227.                     SETUP.ASM file (included with these
  2228.                     utilities) in any ASCII word processor.  You
  2229.                     can then make your modifications and
  2230.                     reassemble the file.
  2231.                                  Page -35-
  2232.  
  2233.                     Even if you do not have a macro assembler and
  2234.                     must therefore use DEBUG.COM to modify
  2235.                     SETUP.COM directly, print out and read the
  2236.                     SETUP.ASM file.  It is heavily commented, and
  2237.                     will give you a good idea of how the
  2238.                     different menu strings and printer control
  2239.                     strings are organized.  Note, however, that
  2240.                     the specific values shown in SETUP.ASM are in
  2241.                     decimal notation; values entered via DEBUG
  2242.                     must be in hexadecimal notation.
  2243.  
  2244.                     The following offset addresses, not those
  2245.                     originally published in PC Magazine, should
  2246.                     be used:
  2247.  
  2248.                     The menu color attributes (4F and 70) are at
  2249.                     offsets xxxx:013F and xxxx:0140.
  2250.  
  2251.                     To change the port number from LPT1: to LPT2:
  2252.                     (or LPT3:) change the default 00 at xxxx:0C7A
  2253.                     and at xxxx:0C84 to 01 (or 02).
  2254.  
  2255.                     The start of the menu text table (532 bytes,
  2256.                     beginning with C9) is at offset xxxx:0151.
  2257.                     The "P" in PRINTER SETUP MENU" is at
  2258.                     xxxx:0172.
  2259.  
  2260.                     The printer control strings themselves begin
  2261.                     at xxxx:09A1.  Each function key (and each
  2262.                     shifted function key, with the exception of
  2263.                     F19 and F20) can be assigned a string up to
  2264.                     16 bytes long.  Each string must include a
  2265.                     delimiter of FF (255 decimal) that marks the
  2266.                     end of the string.  The beginning of the
  2267.                     string for each successive function key
  2268.                     starts at an address that is a multiple of 16
  2269.                     bytes above the base address (xxxx:09A1) of
  2270.                     the table.  You must pad the strings with
  2271.                     zeros for any locations that are not used by
  2272.                     actual control codes, so that each string
  2273.                     begins on a 16-byte boundary.
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.                                  Page -36-
  2295.  
  2296.           SIZE (and ATSIZE)                          Art Merrill
  2297.           Command(s)                                      No. 28
  2298.  
  2299.           ______________________________________________________
  2300.  
  2301.           Purpose:  Calculates the storage requirements of a file
  2302.                     or group of files, based on the number of DOS
  2303.                     clusters necessary to make floppy disk and
  2304.                     hard disk copies.
  2305.  
  2306.           Format:   SIZE [d:]     (all files, default directory)
  2307.                        or
  2308.                     SIZE [d:][path]filename[.ext]
  2309.  
  2310.           Remarks:  DOS stores files in fixed-length allocation
  2311.                     units called "clusters."  For floppy disks,
  2312.                     the cluster size is 1024 bytes (two 512-byte
  2313.                     sectors); for the PC and XT 10-Mb hard disk
  2314.                     the cluster size is 4084 bytes.  On such a
  2315.                     hard disk, whether a file is one byte or 4Kb
  2316.                     in actual length (as reported by DIR), it
  2317.                     requires the same amount (one cluster) of
  2318.                     storage space.  The PC AT's 20-Mb hard disk
  2319.                     is less wasteful in handling small files;
  2320.                     its minimum set-aside (cluster size) is 2048
  2321.                     bytes.  AT users should use ATSIZE.COM.
  2322.  
  2323.                     Entered without parameters, SIZE (or ATSIZE)
  2324.                     returns the number of bytes used by all files
  2325.                     in the current directory, the amount of space
  2326.                     required to copy them to a standard (360K)
  2327.                     floppy disk, and the amount of space required
  2328.                     for hard disk storage.
  2329.  
  2330.                     Entering B:SIZE returns the same information
  2331.                     for a disk in drive B:.  Pathnames and
  2332.                     wildcards are supported, so you could enter
  2333.  
  2334.                          SIZE \PROG\*.COM
  2335.  
  2336.                     to learn the number of .COM files, their
  2337.                     total size and storage requirements,
  2338.                     contained in your \PROG subdirectory.
  2339.  
  2340.                     Notes:
  2341.  
  2342.                     1.   Requires DOS 2.0 or later.
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.                                  Page -37-
  2358.  
  2359.           SNAPSHOT                                Steven Holzner
  2360.           Command (after running .BAS version)            No. 29
  2361.  
  2362.           ______________________________________________________
  2363.  
  2364.           Purpose:  Saves your current screen and up to three
  2365.                     additional prefabricated screens for
  2366.                     immediate display without leaving an
  2367.                     application program.
  2368.  
  2369.           Format:   SNAPSHOT     (loads memory-resident program)
  2370.                     <Ctrl-N>             (stores current screen)
  2371.                     <Ctrl-F>            (displays stored screen)
  2372.                     <Ctrl-A>             (displays screen A.DAT)
  2373.                     <Ctrl-B>             (displays screen B.DAT)
  2374.                     <Ctrl-C>             (displays screen C.DAT)
  2375.  
  2376.           Remarks:  SNAPSHOT is a memory-resident utility that is
  2377.                     incompatible with programs (such as XyWrite)
  2378.                     that take control of the keyboard interrupts.
  2379.                     While written in assembly languge, it is
  2380.                     presented here with a BASIC interface that
  2381.                     need be run only once, but which facilitates
  2382.                     entering the trigger keys you will use to
  2383.                     store the current screen, recall it, and to
  2384.                     recall up to three screens you can prepare
  2385.                     with an ASCII word processor and store under
  2386.                     the filenames A.DAT, B.DAT, and C.DAT.
  2387.  
  2388.                     When you load and run SNAPSHOT.BAS under
  2389.                     BASIC you will be prompted for the required
  2390.                     key selections.  Thereafter the program will
  2391.                     create SNAPSHOT.COM (it takes about two
  2392.                     minutes), which is a regular DOS command.
  2393.  
  2394.  
  2395.           Option 1: If your regular word processor is WordStar,
  2396.                     before running SNAPSHOT.BAS you should edit
  2397.                     it as follows:
  2398.  
  2399.                     1. In line 30, change the checksum shown from
  2400.                     51461 to 51462.
  2401.  
  2402.                     2. In line 430, change the third number (just
  2403.                     to the left of the -2) from 0 to 1.
  2404.  
  2405.                     The purpose of these changes is to provide a
  2406.                     "stripper" function so that WordStar files
  2407.                     will be readable from other applications.
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.                                  Page -38-
  2421.  
  2422.           STATLINE                                    John Socha
  2423.           Command                                         No. 30
  2424.  
  2425.           ______________________________________________________
  2426.  
  2427.           Purpose:  Displays 26th-line status indicators for the
  2428.                     NumLock, CapsLock, and ScrollLock toggle keys
  2429.                     on IBM monochrome, CGA, and Compaq monitors.
  2430.  
  2431.           Format:   STATLINE     (loads memory-resident program)
  2432.  
  2433.           Remarks:  STATLINE converts the normal 25-line text
  2434.                     mode display into 26 lines, using the
  2435.                     additional line to show a # sign for NumLock,
  2436.                     an up arrow for CapsLock, and a double-
  2437.                     pointed arrow for ScrollLock.
  2438.  
  2439.                     On a monochrome display, where insufficient
  2440.                     memory is available for a full 26th line,
  2441.                     two-thirds of that line is used by STATLINE;
  2442.                     the remainder echoes the first portion of the
  2443.                     top line of the regular display.
  2444.  
  2445.                     This utility is not compatible with the IBM
  2446.                     enhanced graphics adapter (EGA) and is best
  2447.                     suited for use with the color graphics
  2448.                     adapter (CGA) and with Compaq displays.
  2449.  
  2450.                     Notes:
  2451.  
  2452.                     1.   STATLINE is a memory-resident utility
  2453.                          and is known to be incompatible with a
  2454.                          number of keyboard macro programs.
  2455.                          Assembly language programmers will be
  2456.                          particularly interested in the extensive
  2457.                          discussion of the problems of co-
  2458.                          residency contained in the original
  2459.                          article (PC Magazine, Volume 5 Number
  2460.                          13), and in the .ASM listing that shows
  2461.                          how to reprogram the 6845 video
  2462.                          controller.
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.                                  Page -39-
  2484.  
  2485.           SWEEP                                  Charles Petzold
  2486.           Command                                         No. 31
  2487.  
  2488.           ______________________________________________________
  2489.  
  2490.           Purpose:  Causes a command to be successively executed
  2491.                     in every subdirectory on a hard disk.
  2492.  
  2493.           Format:   SWEEP Command [parameter(s)]
  2494.  
  2495.           Remarks:  SWEEP starts from the current directory.  In
  2496.                     order to use SWEEP to extend the range of a
  2497.                     command to all the subdirectories on a disk,
  2498.                     use CD (if necessary) to make the root
  2499.                     directory your current directory.  From the
  2500.                     root directory, the command
  2501.  
  2502.                          SWEEP DIR
  2503.  
  2504.                     will display the listings, by subdirectory,
  2505.                     of every non-hidden file on the disk.  To
  2506.                     erase all the .BAK files on a disk you need
  2507.                     only get into the root directory and issue
  2508.                     the command
  2509.  
  2510.                          SWEEP DEL *.BAK
  2511.  
  2512.                     SWEEP itself will not accept parameters other
  2513.                     than its command.  Thus, if you are on drive
  2514.                     C: and wish a directory of all files on drive
  2515.                     D: to be sent to your printer, you must first
  2516.                     make drive D: the current drive before you
  2517.                     issue the command
  2518.  
  2519.                          SWEEP DIR > LPT1
  2520.  
  2521.                     (In this case you would either need a copy of
  2522.                     SWEEP.COM on drive D: or else drive D: would
  2523.                     have to be listed on your PATH.)
  2524.  
  2525.                     SWEEP can execute .BAT file commands (and
  2526.                     even non-DOS commands, such as LOCATE.COM).
  2527.                     A useful file called CLEAN.BAT might consist
  2528.                     of the three lines
  2529.  
  2530.                     DEL *.BAK
  2531.                     DEL *.TMP
  2532.                     DEL *.OBJ
  2533.  
  2534.                     From the root directory, if you then enter
  2535.  
  2536.                          SWEEP CLEAN
  2537.  
  2538.                     all .BAK, .TMP, and .OBJ files will be erased
  2539.                     from the disk.
  2540.  
  2541.                     Notes:
  2542.  
  2543.                     1.   Requires DOS 2.0 or later.
  2544.  
  2545.  
  2546.                                  Page -40-
  2547.  
  2548.           UNDEL (Undelete)                        Steven Holzner
  2549.           Command                                          No.32
  2550.  
  2551.           ______________________________________________________
  2552.  
  2553.           Purpose:  Recovers files on double-sided floppy disks
  2554.                     that have been accidentally deleted.
  2555.  
  2556.           Format:   UNDEL [d:]filename[.ext]
  2557.  
  2558.           Remarks:  Unless special measures are taken, DOS does
  2559.                     not overwrite the contents of a file when it
  2560.                     deletes the file.  Rather, DOS simply changes
  2561.                     the first letter of the filename to E5 in its
  2562.                     directory table and unassigns the second (and
  2563.                     subsequent) clusters for the file from its
  2564.                     file allocation table.  When no files have
  2565.                     been subsequently stored to disk that would
  2566.                     use the deallocated clusters, the deleted
  2567.                     file can usually be recovered intact by
  2568.                     UNDEL.COM.
  2569.  
  2570.                     As an aid to recovery of ASCII files, the
  2571.                     UNDEL command may be given as
  2572.  
  2573.                     UNDEL/A [d:]filename[.ext]
  2574.  
  2575.                     The /A parameter is designed to provide a
  2576.                     display of each proposed cluster to be
  2577.                     recovered before it is actually included in
  2578.                     the undeleted file.  With late versions of
  2579.                     PC-DOS, however, the use of the /A parameter
  2580.                     has been found to return the error message,
  2581.                     "File Not Found Deleted".  In such cases,
  2582.                     entering UNDEL without the added parameter is
  2583.                     normally sufficient to recover the complete
  2584.                     file without loss.
  2585.  
  2586.                     Notes:
  2587.  
  2588.                     1.   UNDEL should not be used on 8-sector
  2589.                          disks (such as the distribution copy
  2590.                          of this disk), but only on 9-sector,
  2591.                          double-sided floppies.
  2592.  
  2593.                     2.   Requires the use of DOS 2.0 or later,
  2594.                          but the command does not recognize
  2595.                          pathnames.
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.                                  Page -41-
  2610.  
  2611.           VTREE (Visual Tree)                    Charles Petzold
  2612.           Command                                         No. 33
  2613.  
  2614.           ______________________________________________________
  2615.  
  2616.           Purpose:  Provides a visual representation of the tree-
  2617.                     structured subdirectories on a hard or floppy
  2618.                     disk.
  2619.  
  2620.           Format:   VTREE [d:]
  2621.  
  2622.           Remarks:  VTREE can display up to the full DOS limit of
  2623.                     32 levels of nested subdirectories.  Its
  2624.                     output may be redirected to a printer, but it
  2625.                     employs IBM "text-graphics" characters that
  2626.                     many printers cannot properly handle.  With
  2627.                     such printers, run PRSWAP.COM (included in
  2628.                     these utilities) before VTREE.
  2629.  
  2630.                     Notes:
  2631.  
  2632.                     1.   Requires DOS 2.0 or later.
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.                                  Page -42-
  2673.  
  2674.           WAITASEC (and SCROLL)                  Charles Petzold
  2675.           Command(s)                                      No. 34
  2676.  
  2677.           ______________________________________________________
  2678.  
  2679.           Purpose:  Uses the single-keystroke ScrollLock key to
  2680.                     halt a fast-scrolling display; then allows
  2681.                     you to scroll backwards, recalling previous
  2682.                     screens.
  2683.  
  2684.           Format:   WAITASEC     (loads memory-resident program)
  2685.                     <ScrollLock>             (activates command)
  2686.  
  2687.           Remarks:  WAITASEC is a memory-resident program that is
  2688.                     normally loaded through your AUTOEXEC.BAT
  2689.                     file.  Thereafter, alternately pressing and
  2690.                     releasing the ScrollLock key will halt and
  2691.                     restart a scrolling display, e.g., a lengthy
  2692.                     DIR listing.
  2693.  
  2694.                     While holding down the ScrollLock key to
  2695.                     freeze the display, if you also press one of
  2696.                     the cursor movement keys (Home, Up Arrow,
  2697.                     PgUp, End, Down Arrow, or PgDn), the display
  2698.                     will not resume scrolling when you release
  2699.                     the ScrollLock key.  Thereafter, the Up and
  2700.                     Down arrow keys move the display by one line,
  2701.                     the PgUp and PgDown move it by 25 lines, and
  2702.                     the Home and End keys take you to the
  2703.                     beginning and end of the stored screen
  2704.                     memory.  Pressing any non cursor key at this
  2705.                     point deactivates the stored mode, and the
  2706.                     original scrolling resumes.
  2707.  
  2708.                     Notes:
  2709.  
  2710.                     1.   WAITASEC will not work with an 80-column
  2711.                          color/graphics display if an unmodified
  2712.                          PC-DOS ANSI.SYS has been loaded.  (The
  2713.                          ANSI.SYS that comes with various
  2714.                          versions of MS-DOS does not cause
  2715.                          problems with WAITASEC.)  To run with
  2716.                          IBM's ANSI.SYS, make a copy
  2717.                          (MODANSI.SYS) of the original ANSI.SYS
  2718.                          and use DEBUG to patch the copy as
  2719.                          follows:
  2720.  
  2721.                          DEBUG MODANSI.SYS
  2722.                          E 29D 90 90
  2723.                          E 2A1 90 90
  2724.                          W
  2725.                          Q
  2726.  
  2727.                          Put the modified MODANSI.SYS in your
  2728.                          CONFIG.SYS file in place of ANSI.SYS.
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.                                  Page -43-
  2736.  
  2737.                     2.   Because of the way they handle TTY
  2738.                          output, certain EGA cards will not
  2739.                          permit WAITASEC to scroll backwards.
  2740.                          This problem can often be cured by
  2741.                          adding MODANSI.SYS, as above.
  2742.  
  2743.                     3.   WAITASEC does not save your current
  2744.                          display screen.  To save your current
  2745.                          display, before beginning a scroll,
  2746.                          enter the complementary SCROLL command,
  2747.                          and everything on the screen will scroll
  2748.                          off the top and be captured in the
  2749.                          WAITASEC buffer.
  2750.  
  2751.                     4.   While WAITASEC has been found compatible
  2752.                          with XyWrite III (XYKBD.COM loaded) on a
  2753.                          PC AT, as with other memory-resident
  2754.                          programs, unforeseen hardware and
  2755.                          software incompatibilities may be
  2756.                          encountered.
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.                                  Page -44-
  2799.  
  2800.           WHERE (File Locator)                     Kiyoshi Akima
  2801.           Command                                         No. 35
  2802.  
  2803.           ______________________________________________________
  2804.  
  2805.           Purpose:  Searches all directories on a particular
  2806.                     drive and lists the paths of entries that
  2807.                     match the specified filename.
  2808.  
  2809.           Format:   [d:][path]WHERE [filename[.ext]]
  2810.  
  2811.           Remarks:  WHERE uses normal DOS filename specifications
  2812.                     to locate files.  Omitting a filename and
  2813.                     extension after the command defaults to WHERE
  2814.                     *.* and will list all non-hidden files on
  2815.                     your disk.
  2816.  
  2817.           Example:  The command WHERE *.BAT will find all
  2818.                     your batch files.  WHERE MO*.* would uncover
  2819.                     MODE.COM and MORE.COM and any other filename
  2820.                     that begin with MO.
  2821.  
  2822.                     Notes:
  2823.  
  2824.                     1.   Although submitted to us by Mr. Akima,
  2825.                          this program has its roots in one
  2826.                          originally written by John Socha.
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.                                  Page -45-
  2862.  
  2863.           XDEL                                    Ronald Czapala
  2864.           Command                                         No. 36
  2865.  
  2866.           ______________________________________________________
  2867.  
  2868.           Purpose:  Successively presents each filename in your
  2869.                     current directory for single-keystroke file
  2870.                     deletion or retention.
  2871.  
  2872.           Format:   XDEL [d:][file.ext]
  2873.  
  2874.           Remarks:  If no parameters are specified with XDEL, the
  2875.                     default filename *.* is used.  Both the
  2876.                     global characters ? and * may be used in
  2877.                     selecting the files to be presented.
  2878.  
  2879.                     The program produces an on-screen menu of
  2880.                     keystroke choices, as follows:
  2881.  
  2882.                     <F1> - deletes current file displayed
  2883.                     <PgDn> - skips current file displayed
  2884.                     <Home> - restarts file display
  2885.                     <Esc> - returns to DOS
  2886.  
  2887.                     Note:
  2888.  
  2889.                     1.   Although XDEL.COM requires DOS 2.0 or
  2890.                          later, you must use CHDIR (CD) if
  2891.                          necessary to make a subdirectory your
  2892.                          current directory.
  2893.                              
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.                                  Page -46-
  2925.